home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / qupdn4.arc / QUPDN4.DOC < prev    next >
Text File  |  1988-09-15  |  7KB  |  200 lines
  1.  
  2.  
  3.  
  4.                                QUPDN version 4.0
  5.  
  6.                                Released  9/10/87
  7.        
  8.  
  9.                             for PC-Board 14.0 ONLY!
  10.  
  11.  
  12.                                 Scott M. Pazur
  13.                                   PO Box 582
  14.                             Englishtown, NJ  07726
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21. What  is  QUPDN4?   Simply  put, QUPDN4 reads your PC-Board  user  file,  and 
  22. creates  a  report  listing your top x downloaders, and/or top  x  uploaders.
  23. QUPDN4  will  report  on  actual  number of  transfers,  and/or  total  bytes
  24. transferred.   The  downloader  report  is done based  on  ratio,  while  the
  25. upload  report  is  based  on  pure  numbers.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                            Version 4 Release Notes:
  33.  
  34.                        New configuration file format!
  35.                      Ascii AND Ansi report capabilities
  36.                   Eight possible reports can be generated
  37.                     Command line DAT file specification
  38.                  Up to five retries on "locked" user file
  39.                         PC-Board 14.0 compatibility 
  40.  
  41.  
  42.  
  43.  
  44. Data file specifications:
  45.      Name:  QUPDN.DAT
  46.      Location:  Current directory or pointed to by the command line
  47.                 switch /D:DatFileLoc&Name
  48.  
  49.      Line 1:  Path/Name of users file (a copy is made and used here)
  50.      Line 2:  Number of entries to include in report (may be lower than
  51.               specified depending on security ranges - below)
  52.               Use a "0" if you want every user in range below listed.
  53.      Line 3:  BBS Name
  54.      Line 4:  Uploader Report specs - If you don't want the top uploaders
  55.               reported, put a "0" in column 1 of this line and go to the 
  56.               next line.  If you DO want the top uploaders reported, column 
  57.               1 must have a "1", and column 2 must have a comma (",").
  58.               Column 3 is either "B" or "N", specifying whether to report
  59.               based on total "B"ytes transferred, or "N"umber of files.
  60.               Comma in column 4.  Two more values are needed, the low and
  61.               high end of the security range to report on, separated by a 
  62.               comma again.  (examples below)
  63.      Line 5:  Downloader Report specs - exactly the same as above.
  64.      Line 6:  ASCII file report specs - if you want an ascii report - no
  65.               colors - put a "1" in column 1, comma, and report name.
  66.               If you do not want a plain ascii report, put "0" in column 1.
  67.      Line 7:  ANSI file report specs - same as Line 6, but this is for the 
  68.               colorized version.  Yes, you can do both, but use different
  69.               file names (obviously).
  70.  
  71.      DO NOT PUT ANY SPACES IN LINES 4 THRU 7!!
  72.  
  73. Examples:
  74. ======================================================================
  75. C:\PCB\MAIN\USERS
  76. 15
  77. The Extinct Flea Market BBS
  78. 1,B,15,75
  79. 1,N,15,99
  80. 1,C:\PCB\GEN\BLT9
  81. 1,C:\PCB\GEN\BLT9G
  82. --> This DAT file reports both top uploaders and downloaders, uploaders
  83.     based on total BYTES uploaded, downloaders based on NUMBER of
  84.     downloads (remember - this is a ratio where uploads are strictly
  85.     numbers).  The range to include in the uploader report is 15 thru
  86.     75, and for downloaders, use the range 15 thru 99 (inclusively).
  87.     Two versions of the output will be created, ascii as BLT9 and
  88.     ansi as BLT9G.  A maximum of 15 entries will be reported.
  89. =======================================================================
  90. C:\PCB\MAIN\USERS
  91. 0
  92. The Testing Point
  93. 0
  94. 1,B,10,20
  95. 0
  96. 1,C:\PCB\GEN\NEWSG
  97. --> This DAT file will report only the top downloaders, using all who 
  98.     fall in the security range 10 thru 20.  No ASCII version of the 
  99.     report is created, but an ANSI version as NEWSG will be.
  100.  
  101.  
  102.  
  103.  
  104. In effect, there are 8 possible reports that can be generated.
  105.  - Uploaders by BYTES
  106.  - Uploaders by NUMBER
  107.  - Downloaders by BYTES
  108.  - Downloaders by NUMBER
  109.  - Uploaders by BYTES, Downloaders by BYTES
  110.  - Uploaders by BYTES, Downloaders by NUMBER
  111.  - Uploaders by NUMBER, Downloaders by BYTES
  112.  - Uploaders by NUMBER, Downloaders by NUMBER
  113.  
  114.  
  115.  
  116. Note:  If you tell the program to list the top 15 (for example) uploaders and
  117.        downloaders, but it only finds 10 users in the range specified in 
  118.        lines 4 and 5, it will adjust itself to include only 10.  Also, and
  119.        read this part carefully, if you tell it to report the top 15, and
  120.        it finds only 8 in the d/l range, and 12 in the u/l range, the report
  121.        will include only the top 8 in each catagory.  In other, maybe more
  122.        confusing words, the report will list the lesser of the number of 
  123.        users in the two security ranges, should either of these numbers be
  124.        less than the desired number of users to report.  This is just to
  125.        keep the output report somewhat uniform.
  126.  
  127.  
  128.  
  129. Did you get all that?  The best way to find out is to make a copy of your 
  130. user file to a floppy or something (eventhough the program only reads the
  131. file, it's better safe than sorry) and give it a shot.  If you like it,
  132. use it.  If not, don't.  Simple enough.
  133.  
  134.  
  135.  
  136. This program is free, I hope you find it useful.
  137.  
  138.  
  139.  
  140. If you need to contact me, since I no longer run a board of my own, the 
  141. easiest place to find me is on one of these fine PC-Board systems:
  142.  
  143.  
  144. The Right Choice BBS    Spring Lake Hts NJ    201-974-8317 Public Node
  145.                                                            1200/2400
  146.  
  147.  
  148. The Jersey Shore BBS    Sayreville NJ         201-613-7350 9600 w/HST
  149.  
  150.  
  151.  
  152.  
  153.  
  154. Revision History:
  155.  
  156. =============================================================================
  157.  
  158. Version 4.0:
  159.  
  160.  - New configuration file format!
  161.  - Ascii AND Ansi report capabilities
  162.  - Eight possible reports can be generated
  163.  - Command line DAT file specification
  164.  - Up to five retries on "locked" user file
  165.  - PC-Board 14.0 compatibility 
  166.  
  167. =============================================================================
  168.  
  169. Version 3.0:
  170.  
  171.  - PC-Board 12.0 compatibility!  And changed the name of the mandatory
  172.    data file to QUPDN.DAT.
  173.  
  174. =============================================================================
  175.  
  176. Version 2.0:
  177.  
  178.    - Mandatory data file, PCBQUPDN.DAT, which MUST be in the directory from
  179.      which you execute QUPDN2.  (layout later)  The use of a data file should
  180.      allow QUPDN2 to work with version 10.0 of PC-Board.  It has only been
  181.      tested with version 11.7.
  182.    - Variable number of users in report, i.e. Top 3 or Top 10 or Top 100
  183.    - User defined report title (70 chars max)
  184.    - Range of security levels to include in report.
  185.      Separate range for uploader list and downloader list.  For example, if
  186.      you give SYSOPs unlimited downloads, you might not want them listed
  187.      in your top downloaders list, but you might want those that upload to
  188.      be listed as one of the top uploaders.  Can be done...
  189.    - User defined report filename/location.  (you might want it as NEWS
  190.                                               or BLTx etc)
  191.  
  192. =============================================================================
  193.  
  194. Version 1.0:
  195.  
  196.    - The initial release
  197.  
  198.  
  199.  
  200.